home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PRINTER / GIFPRT41.ARJ / GIFPRT.DOC next >
Text File  |  1992-01-12  |  22KB  |  595 lines
  1.  
  2.  
  3.  
  4.      GIFPRT User's Guide                                              Page 1
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                GIFPRT User's Guide
  20.                                    Version 4.1
  21.                       Copyright (c) 1992 Edward B. Hamrick
  22.                                All Rights Reserved
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.          Please send all suggestions, error reports, and corrections to:
  50.  
  51.                               Compuserve:    71470,3236
  52.                               Internet:      71470.3236@compuserve.com
  53.                               GEnie:         E.HAMRICK1
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      Copyright (c) 1992 Edward B. Hamrick                             Page 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      GIFPRT User's Guide                                              Page 2
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                    TRADEMARKS
  77.  
  78.      GIF,  Graphics Interchange  Format, and  Compuserve are  trademarks of
  79.      Compuserve, Inc., an H&R Block Company.
  80.  
  81.      GEnie is a trademark of General Electric Company, U.S.A.
  82.  
  83.      IBM  and PC-DOS  are registered  trademarks of  International Business
  84.      Machines   Corporation.    IBM  PC,  XT,  and  AT  are  trademarks  of
  85.      International Business Machines Corporation.
  86.  
  87.      Microsoft   and   MS-DOS  are   registered  trademarks   of  Microsoft
  88.      Corporation.
  89.  
  90.      Hercules is a trademark of Hercules Computer Technology.
  91.  
  92.      Epson is a trademark of Epson America.
  93.  
  94.  
  95.  
  96.  
  97.                                 ACKNOWLEDGEMENTS
  98.  
  99.      GIFPRT was written entirely using Turbo C.
  100.  
  101.      The User's Guide was created using Microsoft Works.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.      Copyright (c) 1992 Edward B. Hamrick                             Page 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      GIFPRT User's Guide                                              Page 3
  137.  
  138.  
  139.      1.0  Introduction
  140.  
  141.           GIFPRT  (jiff-print) is a program  that lets you display and
  142.      print  graphics files  that use the  Graphics Interchange Format,
  143.      commonly  known as  GIF files.   GIFPRT will let  you print using
  144.      almost  any type of  printer, including those  that support Epson
  145.      and  IBM 8-pin and 24-pin graphics, Hewlett Packard Laser printer
  146.      graphics,  and  Toshiba/Qume 24-pin  graphics,  and a  variety of
  147.      color  printers.  GIFPRT can also be used to display any GIF file
  148.      on  almost any type of graphics adapter, including Hercules, CGA,
  149.      EGA, MCGA, VGA, and Super-VGA adapters.
  150.  
  151.           Most  graphics devices are capable  of only displaying a few
  152.      colors  or  shades  of  gray, and  dot-matrix  printers  are only
  153.      capable  of displaying an array of black dots.  However, many GIF
  154.      files  contain images  with up to  256 different  colors.  GIFPRT
  155.      uses  an error-dispersion  algorithm (also called  a dithering or
  156.      half-toning  algorithm) to  try to display  the image  in the GIF
  157.      file.   This  error dispersion  algorithm takes  advantage of the
  158.      number  of colors that an adapter  can display to approximate the
  159.      colors  in the GIF file.  If you have an EGA adapter, GIFPRT will
  160.      display  images in either  a 16-color dithered  pattern, or a 16-
  161.      level dithered gray scale.  If you have a VGA adapter, GIFPRT can
  162.      use  the 256 color display  capability and display images without
  163.      any need for dithering.
  164.  
  165.           There  are a many different printer and adapter resolutions.
  166.      For  instance, some printers can display 60, 120, or 180 dots per
  167.      inch,  in  either the  horizontal or  vertical direction.   Other
  168.      printers  display 72, 144, and 216  dots per inch, and yet others
  169.      display  combinations  of  60  and  72  dots  per  inch  in  both
  170.      directions.  Display resolutions can vary from 320 by 200 pixels,
  171.      to  1280 by 1024  pixels, with a dozen  resolutions between.  GIF
  172.      files   can  contain  images  with   an  equally  wide  range  of
  173.      resolutions.     The  GIFPRT  program  contains  a  sophisticated
  174.      resolution-matching  algorithm to  match the  GIF file resolution
  175.      with the printer or display adapter resolution.
  176.  
  177.           Because  of the wide variety of Super-VGA graphics adapters,
  178.      it  is difficult for one program to support them all.  However, a
  179.      new standard for Super-VGA graphics drivers has been published by
  180.      the  Video Electronics  Standards Association  (VESA) for writing
  181.      programs that use Super-VGA graphics adapters.  To take advantage
  182.      of  the VESA Super-VGA graphics modes,  you need to obtain a VESA
  183.      "BIOS  Extender" program.   These are available  for almost every
  184.      type of Super-VGA graphics adapter on both Compuserve and GEnie.
  185.  
  186.           Even  though GIFPRT handles the  most popular printer types,
  187.      you  may need  to use  a different  printer.   It is  possible to
  188.      customize  GIFPRT to handle almost any other printer (see section
  189.      4.0).
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.      Copyright (c) 1992 Edward B. Hamrick                             Page 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      GIFPRT User's Guide                                              Page 4
  203.  
  204.  
  205.      2.0  Prerequisites
  206.  
  207.           The  following  three  sections  describe  the  hardware and
  208.      software  required to run the GIFPRT program, and describe how to
  209.      register your copy of GIFPRT.
  210.  
  211.      2.1  Hardware Required
  212.  
  213.           In  order to use GIFPRT, you will need an IBM PC, XT, AT, or
  214.      other  compatible  personal computer  with a  minimum of  512K of
  215.      memory.   GIFPRT will run at  any hardware clock speed, including
  216.      4.77  MHz, and can be loaded from  either a floppy disk or a hard
  217.      disk.    GIFPRT will  display GIF  images  on almost  any display
  218.      adapter, and on most Epson, IBM, and HP compatible printers.
  219.  
  220.           If  your printer is connected to a port other than LPT1, you
  221.      will  need to  use the  DOS MODE  command to  direct LPT1  to the
  222.      proper port.
  223.  
  224.      2.2  Software Required
  225.  
  226.           In  order to run GIFPRT,  you will need a  copy of MS-DOS or
  227.      PC-DOS,  version  2.1 or  higher.   You  also need  the following
  228.      GIFPRT files:
  229.  
  230.           GIFPRT.EXE     Main GIFPRT program
  231.           GIFPRT.PR0     Epson 8-pin 120x72 dpi print commands
  232.           GIFPRT.PR1     Epson 8-pin 120x60 dpi print commands
  233.           GIFPRT.PR2     IBM 8-pin 120x72 dpi print commands
  234.           GIFPRT.PR3     IBM 8-pin 120x60 dpi print commands
  235.           GIFPRT.PR4     Epson 24-pin 240x216 dpi print commands
  236.           GIFPRT.PR5     Epson 24-pin 180x180 dpi print commands
  237.           GIFPRT.PR6     HP Laser 75x75 dpi print commands
  238.           GIFPRT.PR7     HP Laser 150x150 dpi print commands
  239.           GIFPRT.PR8     Toshiba 24-pin 180x180 dpi print commands
  240.           GIFPRT.DOC     GIFPRT User's Guide
  241.  
  242.           If you have a Super-VGA graphics adapter, you'll need to get
  243.      the  VESA BIOS Extension program for your particular adapter, and
  244.      load it prior to running GIFPRT.
  245.  
  246.           GIFPRT is capable of using Expanded (EMS) memory for storing
  247.      GIF  files larger than those that will fit into your main memory.
  248.      To  use this feature, you'll have to load the EMS driver prior to
  249.      running  GIFPRT.  If you don't have EMS, but you do have a system
  250.      with  a 386 processor, you can load the EMM386 driver to simulate
  251.      EMS with the Extended memory in your system.  If you don't have a
  252.      386 processor, you can use one of several shareware programs that
  253.      simulate  EMS by using space on  your hard disk.  GIFPRT displays
  254.      the amount of main memory and EMS memory it is able to use in the
  255.      lower left corner of the main GIFPRT display
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.      Copyright (c) 1992 Edward B. Hamrick                             Page 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      GIFPRT User's Guide                                              Page 5
  269.  
  270.  
  271.      2.3  Registering GIFPRT
  272.  
  273.           GIFPRT is distributed via Compuserve and GEnie as shareware,
  274.      and  may be evaluated for 14 days  without charge.  If you decide
  275.      you  want to purchase GIFPRT, you  can register GIFPRT by running
  276.      it  and  following the  on-screen instructions  for registration.
  277.      GIFPRT  is fully functional  before it is  registered, except for
  278.      the  Super-VGA  256-color display  modes.   When  the  program is
  279.      registered,  you will receive a  password that enables the Super-
  280.      VGA  256-color display modes.  The Super-VGA 2-color and 16-color
  281.      display modes are enabled without registration.
  282.  
  283.           The  GIFPRT  Code  that  is  displayed  on  the registration
  284.      request screen is a simple checksum of the ROM BIOS (top 8 KBytes
  285.      of  8088 address space).  The first four digits are the checksum,
  286.      and  the last four  digits are the one's  complement of the first
  287.      four.   The password  you are sent  will work on  all IBM PC's or
  288.      compatibles  that  have  the same  ROM  BIOS.   However,  you are
  289.      requested  to purchase one password for each computer you will be
  290.      running GIFPRT on.
  291.  
  292.           If  you have received  a password for  a previous version of
  293.      GIFPRT,  it will continue  to function with Version  4.1.  If you
  294.      want  to move your copy of GIFPRT  to a different computer, or if
  295.      your  password doesn't work for any  other reason, please send an
  296.      e-mail  message or write for  a new password.   Please be sure to
  297.      include  the GIFPRT  code that  is displayed  on the registration
  298.      request screen.
  299.  
  300.      3.0  Running GIFPRT
  301.  
  302.           To run GIFPRT, type the following command at a DOS prompt:
  303.  
  304.      GIFPRT [options] [files]
  305.  
  306.           You can get on-line help by typing:
  307.  
  308.      GIFPRT -H      Gives list of command-line and interactive options
  309.  
  310.      GIFPRT -G?     Gives list of display modes
  311.  
  312.      GIFPRT -P?     Gives list of display modes
  313.  
  314.           If  you want to terminate GIFPRT,  press the escape key once
  315.      if you are in interactive mode, or twice if you are displaying an
  316.      image.   You can always terminate any long-running function (such
  317.      as printing a GIF file) by simply hitting any key.
  318.  
  319.           GIFPRT chooses whether to use color (white on blue) or black
  320.      and  white  for it's  interactive screens  based on  the starting
  321.      display mode.  If you want color screens, type "MODE CO80" before
  322.      starting GIFPRT.  If you want black and white screens, type "MODE
  323.      BW80" or "MODE MONO" before starting GIFPRT.
  324.  
  325.  
  326.  
  327.  
  328.      Copyright (c) 1992 Edward B. Hamrick                             Page 5
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      GIFPRT User's Guide                                              Page 6
  335.  
  336.  
  337.           If  you begin GIFPRT without specifying any files, all files
  338.      in  the  current  directory  with the  ".GIF"  extension  will be
  339.      displayed  on an interactive file display screen.  You can select
  340.      a  different file by using the  arrows, space bar, backspace key,
  341.      PageUp,  PageDown, Home, and End keys  to change the active file.
  342.      You  can also use  any other interactive  option described below.
  343.      The  last line of  the display shows the  current settings of the
  344.      various options.
  345.  
  346.           When  you want  to display  or print  the currently selected
  347.      file,  press the Enter key.  While a file is being displayed, you
  348.      may press any key that you could press while in interactive mode.
  349.      To  return  to the  interactive  file display  screen,  press the
  350.      Escape key.  To exit the program, press the Escape key once more.
  351.  
  352.      3.1  Black/White Option   (-W  or W in interactive mode)
  353.  
  354.           This  option causes a GIF file  to be displayed in black and
  355.      white instead of color.  It is toggled on and off each time it is
  356.      used.
  357.  
  358.      3.2  LCD Option           (-L  or L in interactive mode)
  359.  
  360.           You  can use  the LCD  option to  display GIF  files on many
  361.      laptop  displays.  These displays often  use dark dots to make up
  362.      an  image, instead  of the white  dots normally  used on graphics
  363.      displays.  It is toggled on and off each time it is used.
  364.  
  365.      3.3  Brightness Option    (-Bn or +- in interactive mode)
  366.  
  367.           You  can use the  brightness option to  increase or decrease
  368.      the  intensity  of a  GIF file.   This  is sometimes  useful when
  369.      printing  on 24-pin printers, when the image is too dark, or when
  370.      you  want  to avoid  wearing out  the print  ribbon.   The normal
  371.      brightness  option  is 5,  the brightest  setting  is 9,  and the
  372.      darkest  is 1.  A brightness of 9 increases the minimum intensity
  373.      to  80%  of the  maximum,  and a  brightness  of 1  decreases the
  374.      maximum  intensity to 20% of the minimum.  A brightness of 5 does
  375.      not alter the image.
  376.  
  377.      3.4  Contrast Option      (-Cn or /* in interactive mode)
  378.  
  379.           You can use the contrast option to change the contrast in an
  380.      image.  This is primarily useful for adjusting for dot overlap on
  381.      printed images.  Normal contrast is 5, and contrast values can go
  382.      from 1 to 9.
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.      Copyright (c) 1992 Edward B. Hamrick                             Page 6
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      GIFPRT User's Guide                                              Page 7
  401.  
  402.  
  403.      3.5  Graphics Type Option (-Gn or F1-F8,1,2,3 in interactive mode)
  404.  
  405.           You  can use the graphics type  option to select the type of
  406.      graphics  adapter  and  display mode.    You  can get  a  list of
  407.      supported graphics options by typing GIFPRT -G?, or typing F10 in
  408.      interactive  mode.    Function  keys  F1  through  F8  change the
  409.      graphics   mode  from  lowest  to  highest  resolution  while  in
  410.      interactive mode.  The number keys 1, 2, and 3 change to 2-color,
  411.      16-color,  and 256-color  mode, respectively.   If  GIFPRT hasn't
  412.      been  registered, the  7 highest  resolution 256-color  modes are
  413.      displayed with a checkerboard overlay.
  414.  
  415.           The  current display  mode is  displayed in  the lower-right
  416.      hand corner of the screen in interactive mode.
  417.  
  418.      3.6  Printer Type Option  (-Pn or ^F1-^F9,1,2 in interactive mode)
  419.  
  420.           You  can use the  printer type option to  select the type of
  421.      printer.   You  can get  a list  of supported  printers by typing
  422.      GIFPRT  -P?, or typing  ^F10 in interactive  mode.  Function keys
  423.      ^F1  through  ^F9 change  the printer  type while  in interactive
  424.      mode.   The number  keys 1 and  2 change to  2-color and 16-color
  425.      mode, respectively.
  426.  
  427.           The  current printer  type is  displayed in  the lower-right
  428.      hand corner of the screen in interactive mode.
  429.  
  430.      3.7  Dithering Option     (-D  or D in interactive mode)
  431.  
  432.           The  dithering option can be  used to disable dithering, and
  433.      to  display  the closest  available colors.   This  option allows
  434.      quicker  viewing  of  GIF files,  and  sometimes  produces better
  435.      looking  images of cartoon-like GIF files.   It is toggled on and
  436.      off each time it is used.
  437.  
  438.      3.8  Keep Image Option    (-K)
  439.  
  440.           The keep image option can be used to leave a displayed image
  441.      on  the screen  when GIFPRT  exits.   Normally GIFPRT  erases the
  442.      screen   and  restores  the  original  display  mode  upon  exit.
  443.      However,  if you are invoking GIFPRT from a batch (.BAT) file, or
  444.      starting  it  from within  another program,  you can  prevent the
  445.      restoration  of the original display mode by using the -K option.
  446.      It is toggled on and off each time it is used.
  447.  
  448.      3.9  Slide Show Option    (-S)
  449.  
  450.           The  slide  show option  is used  to continuously  display a
  451.      group  of GIF  files on the  screen.   When the last  GIF file is
  452.      displayed,  GIFPRT starts over with the first GIF file.  Normally
  453.      GIFPRT  waits for a  keypress after displaying a  GIF file.  With
  454.      the slide show option, no keypress is required between GIF files.
  455.      It is toggled on and off each time it is used.
  456.  
  457.  
  458.  
  459.  
  460.      Copyright (c) 1992 Edward B. Hamrick                             Page 7
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      GIFPRT User's Guide                                              Page 8
  467.  
  468.  
  469.      4.0  Customizing GIFPRT
  470.  
  471.           If you have a printer that isn't supported by the -P option,
  472.      or  if you want to use a  different print mode, you can customize
  473.      your  version of GIFPRT  by editing the  files GIFPRT.PR0 through
  474.      GIFPRT.PR8.
  475.  
  476.           The   printer  description  files  contain  8  lines.    For
  477.      instance,  the file GIFPRT.PR0 contains a description of an Epson
  478.      120 dot per inch printer.  The contents of this file are:
  479.  
  480.  
  481.           nam Epson/8-pin/120x72dpi
  482.           pal 1   0   0   0        ; Black
  483.           pal 2 255 255 255        ; White
  484.           pal 3   0 255 255        ; Cyan
  485.           pal 4 255   0 255        ; Magenta
  486.           pal 5 255 255   0        ; Yellow
  487.           pin    8    0            ; Pins, raster type
  488.           dpi  120   72            ; Dots per inch, (hor, ver)
  489.           dim  960  720            ; Dimensions (hor, ver)
  490.           ini  6 27 85  1 27 51 24 ; Page initialization
  491.           skp  2 13 10             ; Fast skip over 1 set of pins
  492.           gra  6 27 76 -99 -1 13 10 ; Per-line data (black/white)
  493.           col 30 27 114 0 27 76 -99 -1
  494.                  27 114 2 27 76 -99 -3
  495.                  27 114 1 27 76 -99 -4
  496.                  27 114 4 27 76 -99 -5 13 10   ; Per-line data (color)
  497.           trm  7 27 85  0 27 51 36 12          ; Page termination
  498.  
  499.           Each  line begins  with a  three-letter keyword.   The "nam"
  500.      line is the name of the print mode.  The "pal" lines describe the
  501.      color palette for the color print mode (color number, red, green,
  502.      blue).    The "pin"  line  contains the  number  of pins  used in
  503.      printing  (this is  the number  of bits  sent to  the printer per
  504.      column)  followed by the type of  printer raster data.  The "dpi"
  505.      line  is  the resolution  of the  printer  in the  horizontal and
  506.      vertical  directions, in  dots per inch.   The "dim"  line is the
  507.      dimensions  of  the print  area  horizontally and  vertically, in
  508.      dots.  The last "ini" line describes the string to be sent to the
  509.      printer  upon initialization.   The  "skp" line  describes how to
  510.      skip  to the  start of  image.  The  "gra" line  describes how to
  511.      output  black/white graphics and the  "col" line describes how to
  512.      output  color graphics (a -99 is the length of the data, and a -N
  513.      substitutes  the  raster  data  for  color  N).  The  "trm"  line
  514.      describes  the data to  be send on image  termination.  The first
  515.      number  is  the  number  of characters  in  the  string  and each
  516.      subsequent  number is the numeric value of the code to be sent to
  517.      the printer.
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.      Copyright (c) 1992 Edward B. Hamrick                             Page 8
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      GIFPRT User's Guide                                              Page 9
  533.  
  534.  
  535.           The  raster types are  0 (8-pin Epson),  1 (24-pin Epson), 2
  536.      (75-dpi  HP printers),  3 (150  dpi HP  printers), and  4 (24-pin
  537.      Toshiba(Qume)).
  538.  
  539.      6.0  Implementation Details
  540.  
  541.           GIFPRT  Version  4.1  now  does  dithering  in  a  way  that
  542.      preserves printer ribbons, reduces head wear, and provides higher
  543.      print quality on both dot-matrix and laser printers.
  544.  
  545.           In  all print  modes, the bit  image data  is produced using
  546.      error-dispersion  dithering.   However, for  8-pin display modes,
  547.      half  as  much data  is  produced as  the  printer is  capable of
  548.      displaying, and the data is spread out in the pattern:
  549.  
  550.           x         ->        x-
  551.           x         ->        -x
  552.           x         ->        x-
  553.           x         ->        -x
  554.  
  555.           For  24-pin  display  modes,  one quarter  as  much  data is
  556.      produced as the printer is capable of displaying, and the data is
  557.      spread out in the pattern:
  558.  
  559.           x         ->        -x--
  560.           x         ->        x---
  561.           x         ->        --x-
  562.           x         ->        ---x
  563.  
  564.           For  150-dpi  laser  display  modes, half  as  much  data is
  565.      produced as the printer is capable of displaying, and the data is
  566.      spread out in the pattern:
  567.  
  568.           xxxxxxxxx ->        -x-x-x-x-x-x-x-x
  569.           xxxxxxxxx ->        x-x-x-x-x-x-x-x-
  570.  
  571.      7.0  Tested Features
  572.  
  573.           GIFPRT  Version 4.1 has been extensively tested on Hercules,
  574.      CGA,  EGA, VGA, and Super-VGA display adapters.  It has also been
  575.      tested with a Panasonic KX-P1124 printer.
  576.  
  577.           The   data  stream  produced  for   HP  Laser  printers  and
  578.      Toshiba/Qume  printers has been closely examined for correctness,
  579.      but  GIFPRT has not been tested  with the actual printers.  Color
  580.      printer  support has not  been tested, but  the data stream looks
  581.      correct.   Please  let me  know if  any of  these features aren't
  582.      working, and I'll try to fix them right away.
  583.  
  584.           Anyone  reporting a GIFPRT  bug at the  time of registration
  585.      may register GIFPRT for only $25.00.
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.      Copyright (c) 1992 Edward B. Hamrick                             Page 9
  593.  
  594.  
  595.